home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 February / Macworld (1999-02).dmg / Serious Demos / XTension demo / XTension manual 2.0 / XTension manual 2.0.rsrc / TEXT_132.txt < prev    next >
Text File  |  1998-07-18  |  7KB  |  158 lines

  1.  
  2. I think I "Got It, Just get me going" :                                          
  3.  
  4. Or, if the manual is just too much, 
  5. how do I just make things  GO ? :
  6.  
  7. If this doesn't make sense, just keep going through the manual....
  8. AND Please see the tutorials and articles at  WWW.SHED.COM.
  9.  
  10. ‚Ä¢ You should think about what you want to do with your whole
  11.    house, even if you don't intend to install everything at once.
  12.  
  13.    This will save a lot of time and bother later.  Be most careful
  14.    if you are a programmer, it is easy to substitute skill with
  15.    the coding pencil for just a little forethought...
  16.  
  17. Just the keys :
  18.  
  19. ‚Ä¢ Once you have started up XTension, choose New Unit from the
  20.      File Menu...
  21.  
  22. ‚Ä¢ Give a name to the new unit.  ie: Closet Lamp  ( you choose the address )
  23. ‚Ä¢ Type in the House and Unit code of the device : (address)
  24.         Since it is a lamp, make it 'dimmable'
  25. ‚Ä¢ Click OK and see the the unit appears in the Master List.
  26.  
  27. ‚Ä¢ Choose New Unit again and :
  28. ‚Ä¢ Type in the Name "Closet Motion"  ( you choose the address )
  29. ‚Ä¢ Type in the House and Unit code of the device : (address)
  30.    Since it is a motion sensor, choose to type in a simple
  31.    script which makes other things happen when it 'goes on or off'...
  32.    ‚Ä¢ Choose the ON script button:
  33.    ‚Ä¢ Type in the ON script for "Closet Motion" :
  34.       turnon "Closet Lamp"
  35.       (yes, that's all for now)
  36.  
  37. Now, click OK, twice, and find both Closet Lamp and Closet Motion in the Master List.  Notice that the Closet Motion unit has a  ‚àö indicating that there is a script attached to this unit.
  38.  
  39. ‚Ä¢ Double-click on "Closet Motion" in the Master List, and 
  40. watch the "Closet Lamp" turn ON.  
  41.  
  42. ‚Ä¢ Double-click it again, and watch nothing happen.
  43.  
  44. ‚Ä¢ Except that these events are recorded in the LOG window !  LOOK !
  45.  
  46. ‚Ä¢ Now,  point and click once on "Closet Lamp" in the Master List.
  47.       Hit the ENTER key...
  48.  
  49. Now we're editing the unit  "Closet Lamp" again :
  50. ‚Ä¢ Click on the ON script button...
  51.  
  52. Now we're creating a new ON script for this lamp.
  53. ‚Ä¢ Type in :
  54.       turnoff  "Closet Lamp" in 2 * minutes
  55.  
  56. ‚Ä¢ Click OK,  ( and again to get out of the Edit Unit dialog )
  57.      (now both the lamp and the motion sensor have ON scripts ‚àö )
  58.  
  59. ‚Ä¢ Now select from the Windows Menu :  Scheduled Events
  60.  
  61. ‚Ä¢ Now, If the Closet Lamp and Motion are off :
  62. ‚Ä¢ Double-Click on the "Closet Motion"
  63.         watch the "Closet Lamp" turn ON
  64. ‚Ä¢ SEE a new event appear in the Scheduled Events Window
  65.    In 2 minutes, the "Closet Lamp" will be turned OFF
  66.  
  67. After you watch the Closet Lamp turn OFF: 
  68.  in the List, Scheduled Events Window and especially the LOG !
  69.  
  70. Second example:
  71.  
  72. ‚Ä¢ Click select the "Closet Motion" unit in the Master List.
  73. ‚Ä¢ Type Option-O (as in ON)
  74.       You will immediately see the ON script for the "Closet Motion" unit
  75.  
  76. ‚Ä¢ Change the script to :
  77.       if status of "Closet Lamp" is false then
  78.             turnon  "Closet Lamp" for 2 * minutes
  79.         end if
  80.  
  81. ‚Ä¢ Click OK
  82. ‚Ä¢ Click-select "Closet Lamp" in the Master List.
  83. ‚Ä¢ Type ENTER key
  84.  
  85. ‚Ä¢ Click on the DELETE button for the ON script.
  86. ‚Ä¢ Click OK, OK
  87.  
  88. Now, only the "Closet Motion" unit has a ‚àö saying it has a script.
  89.  
  90. ‚Ä¢ Now Double-Click the "Closet Motion" 
  91. ‚Ä¢ If it was still ON, then nothing will happen....do it again
  92. ‚Ä¢ If it is OFF, then the new script will turn it on for 2 minutes and then OFF
  93.    ( notice the Scheduled Event is there again...)
  94.  
  95.  
  96. In the first example, the motion sensor script turned on the lamp which stimulated it's ON script which turned itself off in two minutes.
  97.  
  98. In the second example, we used another  XTension option and needed only one script which turned on the lamp for 2 minutes.
  99.  
  100. In each case, the result is the same.  It just depends on how you want to write your scripts.
  101.  
  102. There are some subtle differences :
  103.  
  104. In the first example, 
  105.       -  the Closet Lamp controls it's own turn off time.
  106.       -  the Closet Motion sensor ON always turns on the Lamp
  107.       -  this can cause multiple scheduled events to turn off the Lamp...
  108.       -  if any other script turns the Closet Lamp ON, the Lamp's
  109.           script will turn itself OFF in 2 minutes...
  110.            ( unless you use the 'with no script' option )
  111.       -  one script turns ON a unit which has an ON script...
  112.  
  113.  In the second example,
  114.       -  the Closet Lamp is not turned ON if it's already ON.
  115.       -  the Closet Lamp will stay on for 2 minutes and thereafter,
  116.            if the Closet Motion sensor goes ON again, you will get 
  117.            2 more minutes of Closet Lamp...
  118.       -  there is only one script involved
  119.  
  120. These may be subtle differences, but it will come clear as you add devices such as a "Coffee Pot".
  121.  
  122. If the Closet Lamp is left ON for too long, it isn't any big deal.  But if the Coffee Pot is left on for 10-12 hours, it can be a big mess.
  123.  
  124. So, you might want to use the above example 1 for the Coffee Pot, so that
  125. any time you turn it on, it will always schedule an OFF event  within 2 hours.  You might think that the Coffee didn't come on and issue the command manually, via a wireless remote, and you're groggy...
  126.  
  127. This may mean multiple events are scheduled to turn the Coffee Pot OFF, but that's OK  !!
  128.  
  129. These subtle things are the reason why we have so many XTension verbs.
  130.  
  131. And it is why we provide the scripting and scheduled events system where you can schedule an event for 10AM or 3AM etc which routinely goes around and commands all your devices into their default states...sort of a garbage collector....
  132.  
  133. You might choose to have a script called "Spring Cleaning" which turns on all of the light in your hidden places and keeps them on until you either manually command it off, or the 'garbage collector' comes around...
  134.  
  135. Likewise, you might have a motion sensor which not only sends an ON, but also sends an OFF when motion has been absent for a period of time.
  136.  
  137. In this case, you might have an OFF script for the motion sensor which simply turns OFF the Closet Lamp.  You choose the time period for the OFF with physical settings on the motion sensor.
  138.  
  139. Putting this all together, you might easily create a very hospitable system which does things like :
  140.  
  141.       If it's a weekday and the "shower motion" indicates that there's a live body
  142.       in the shower, turn off the"bedroom alarm", turn on the radio, and bring up
  143.       the lights in the house if it's still dark outside...
  144.  
  145. Don't forget that you can also use all of the facilities of your Mac :
  146. Voice annunciation, speech recognition, sound files, video capture,  .....
  147.  
  148. Eventually, you should come back and look further in the Manual.....
  149.  
  150. Don't  forget when you want to turn on everything for real, you must Set Serial Comms ON, and turn Monitor mode OFF before you can actually
  151. issue commands....
  152.  
  153. And, please, don't start taking extraordinary measures such as resetting your PRAM or re-installing your system before looking for something much simpler......it's simpler than you think.
  154.  
  155. If you can at all get to the Internet, then Please visit our site at
  156.  ( www.shed.com)
  157.  
  158.